home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / PROGTOOL / GZIP107S.ZIP;1 / GZIP107.TAR / gzip-1.0.7 / vms / gzip.hlp next >
Encoding:
Text File  |  1993-03-18  |  7.6 KB  |  180 lines
  1. 1 GZIP
  2. NAME
  3.      gzip, gunzip, zcat - compress or expand files
  4.  
  5. SYNOPSIS
  6.      gzip [ -cdfhLrtvV19 ] [ name ... ]
  7.      gunzip [ -cfhLrtvV ] [ name ... ]
  8.      zcat [ -hLV ] [ name ... ]
  9.  
  10. 2 DESCRIPTION
  11.      Gzip reduces the size of the named  files  using  Lempel-Ziv
  12.      coding  (LZ77).  Whenever possible, each file is replaced by
  13.      one with an extension *-z, while keeping the same  ownership
  14.      modes,  access  and  modification  times.   If  no files are
  15.      specified, the standard input is compressed to the  standard
  16.      output.  If the new file name is too long, gzip truncates it
  17.      and keeps the original file name  in  the  compressed  file.
  18.      Gzip  will  only attempt to compress regular files.  In par-
  19.      ticular, it will ignore devices.
  20.  
  21.      Compressed files can be  restored  to  their  original  form
  22.      using gzip -d or gunzip or zcat.
  23.  
  24.      gunzip takes a  list  of  files  on  its  command  line  and
  25.      replaces  each  file whose name ends with -z and which begins
  26.      with the correct magic number  with  an  uncompressed file
  27.      without the original extension. gunzip also recognizes the
  28.      special  extensions .tgz and .taz as shorthand for .tar-z.
  29.  
  30.      gunzip can currently decompress files created by gzip,  zip,
  31.      compress  or  pack.  The  detection  of  the input format is
  32.      automatic.  When using the first two formats, gunzip  checks
  33.      a  32  bit  CRC.  For  pack,  gunzip checks the uncompressed
  34.      length. The compress format was not designed to  allow  con-
  35.      sistency  checks. However gunzip is sometimes able to detect
  36.      a bad .Z file. If you get an error when uncompressing  a  .Z
  37.      file,  do  not  assume  that  the  .Z file is correct simply
  38.      because the standard uncompress does not complain. This gen-
  39.      erally means that the standard uncompress does not check its
  40.      input, and happily generates garbage output.
  41.  
  42.      Files created by zip can be uncompressed  by  gzip  only  if
  43.      they  have  a  single member compressed with the 'deflation'
  44.      method. This feature is only intended to help conversion  of
  45.      tar.zip files to the tar.z format. To extract zip files with
  46.      several members, use unzip instead of gunzip.
  47.  
  48.      zcat is identical to gunzip -c. zcat uncompresses  either  a
  49.      list  of files on the command line or its standard input and
  50.      writes the uncompressed data on standard output.  zcat  will
  51.      uncompress  files that have the correct magic number whether
  52.      they have a -z suffix or not.
  53.  
  54.      Gzip uses the Lempel-Ziv algorithm used in  zip  and  PKZIP.
  55.      The  amount  of  compression obtained depends on the size of
  56.      the input and the distribution of common substrings.   Typi-
  57.      cally,  text  such  as  source code or English is reduced by
  58.      60-70%.  Compression is  generally  much  better  than  that
  59.      achieved  by  LZW  (as used in compress), Huffman coding (as
  60.      used in pack), or adaptive Huffman coding (compact).
  61.  
  62.      Compression is always performed, even if the compressed file
  63.      is  slightly larger than the original. The worst case expan-
  64.      sion is a few bytes for the gzip file header, plus  5  bytes
  65.      every  32K  block, or an expansion ratio of 0.015% for large
  66.      files.  gzip preserves the mode, ownership and timestamps of
  67.      files when compressing or decompressing.
  68.  
  69. 2 OPTIONS
  70.      -c --stdout
  71.           Write output on standard output;  keep  original  files
  72.           unchanged.   If there are several input files, the out-
  73.           put consists of a sequence of independently  compressed
  74.           members.  To obtain better compression, concatenate all
  75.           input files before compressing them.
  76.  
  77.      -d --decompress
  78.           Decompress.
  79.  
  80.      -f --force
  81.           Force compression even if the corresponding file already
  82.           exists. If -f is not given, and when not running in the
  83.           background, gzip prompts to verify whether an existing
  84.           file should be overwritten.
  85.  
  86.      -h --help
  87.           Display a help screen.
  88.  
  89.      -L --license
  90.           Display the gzip license.
  91.  
  92.      -q --quiet
  93.           Suppress all warnings.
  94.  
  95.      -r --recurse
  96.           Travel the directory structure recursively. If  any  of
  97.           the file names specified on the command line are direc-
  98.           tories,  gzip  will  descend  into  the  directory  and
  99.           compress  all  the  files it finds there (or decompress
  100.           them in the case of gunzip ).
  101.  
  102.      -t --test
  103.           Test. Check the compressed file integrity.
  104.  
  105.      -v --verbose
  106.           Verbose. Display the name and percentage reduction  for
  107.           each file compressed.
  108.  
  109.      -V --version
  110.           Version. Display the  version  number  and  compilation
  111.           options.
  112.  
  113.      -# --fast --best
  114.           Regulate the speed of compression using  the  specified
  115.           digit  #,  where  -1  or  --fast  indicates the fastest
  116.           compression method (less compression) and -9 or  --best
  117.           indicates   the  slowest  compression  method  (optimal
  118.           compression).  The default compression level is -5.
  119.  
  120. 2 ENVIRONMENT
  121.      The environment variable GZIP_OPT can hold a set of  default
  122.      options  for  gzip.  These options are interpreted first and
  123.      can be overwritten by explicit command line  parameters. For
  124.      example:
  125.            GZIP_OPT == "-8 -v"
  126.  
  127. 2 SEE ALSO
  128.      compress, zip, unzip
  129.  
  130. 2 DIAGNOSTICS
  131.  
  132.      Usage: gzip [-cdfhLrtvV19] [file ...]
  133.              Invalid options were specified on the command line.
  134.      file: not in gzip format
  135.              The  file  specified  to   gunzip   has   not   been
  136.              compressed.
  137.      file: Corrupt input. Use zcat to recover some data.
  138.              The compressed file has been damaged. The data up to
  139.              the point of failure can be recovered using
  140.              define /user sys$output file.recover
  141.                      zcat file
  142.      file: compressed with xx bits, can only handle yy bits
  143.              File was compressed (using LZW) by  a  program  that
  144.              could  deal  with more bits than the decompress code
  145.              on this machine.  Recompress  the  file  with  gzip,
  146.              which compresses better and uses less memory.
  147.      file: already has z suffix -- no change
  148.              The  file  is  assumed  to  be  already  compressed.
  149.              Rename the file and try again or use zcat.
  150.      file already exists; do you wish to overwrite (y or n)?
  151.              Respond "y" if  you  want  the  output  file  to  be
  152.              replaced; "n" if not.
  153.      gunzip: corrupt input
  154.              A SIGSEGV violation was detected which usually means
  155.              that the input file has been corrupted.
  156.      xx.x%
  157.              Percentage  of  the  input  saved  by   compression.
  158.              (Relevant only for -v.)
  159.      -- not a regular file or directory: ignored
  160.              When the input file is not a regular file or  direc-
  161.              tory, it is left unaltered.
  162.  
  163. 2 CAVEATS
  164.      On VMS:
  165.      - upper case options need quotes: gzip "-V".
  166.      - restoration of timestamps and version numbers is not supported
  167.      - If a compressed file already exists, gzip -f overwrites it, it
  168.        does not create a new version.
  169.      - wildcards in file names are not supported.
  170.      - multi-part gzip files are not supported.
  171.      - gunzip does not preserver the input file format. You can use a
  172.        separate utility to restore the original format.
  173.      - gunzip and zcat can be used only if you have created the
  174.        links to gzip as documented in makegzip.com.  Otherwise
  175.        you must use explicit parameters ("gzip -c" or "gzip -dc").
  176.  
  177. 2 BUGS
  178.      On VMS, files in VFC record format are not correctly handled by
  179.      the C runtime library (the linefeed character is suppressed).
  180.